home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / programs / sinf210.zip / SITEINFO.DOC < prev    next >
Text File  |  1993-02-28  |  17KB  |  491 lines
  1.  
  2.  
  3.                     RSI - random-siteinfo-system - page 1
  4.  
  5.  
  6.         ╓─────────┐
  7.         ║  ┌───╖  │
  8.         ║  │   ╙──┘ ╓───┐ ╓─────┐ ╓─────┐ ╓───┐ ╓────┐╓─┐ ╓─────┐ ╓─────┐
  9.         ║  └──────┐ ╙╖ ┌┘ ╙─╖ ┌─┘ ║ ┌───┘ ╙╖ ┌┘ ║ ┌╖ │║ │ ║ ┌───┘ ║ ┌─╖ │
  10.         ╙──────╖  │  ║ │    ║ │   ║ └─┐    ║ │  ║ │║ │║ │ ║ └─┐   ║ │ ║ │
  11.         ╓──┐   ║  │  ║ │    ║ │   ║ ┌─┘    ║ │  ║ │║ │║ │ ║ ┌─┘   ║ │ ║ │
  12.         ║  └───╜  │ ╓╜ └┐   ║ │   ║ └───┐ ╓╜ └┐ ║ │║ └╜ │ ║ │     ║ └─╜ │
  13.         ╙─────────┘ ╙───┘   ╙─┘   ╙─────┘ ╙───┘ ╙─┘╙────┘ ╙─┘     ╙─────┘
  14.  
  15.                    The multi-mailer-random-siteinfo-system!
  16.  
  17.                              Release version 2.10
  18.     ──────────────────────────────────────────────────────────────────────
  19.                       This program and documentation is
  20.                             copyrighted material.
  21.  
  22.                           It is (c) by Peter Hampf,
  23.                           Graf von Galen Strasse 27
  24.                                  2848 Vechta
  25.                                    Germany
  26.  
  27.                             Fidonet 2:240/11 & 22
  28.     ──────────────────────────────────────────────────────────────────────
  29.  
  30.    ┌──────────────────────────────────────────────────────────────────┐
  31.    │  ▓▓▓▓▓▒▒▒▒▒░░░░░         1.) What it is ...      ░░░░░▒▒▒▒▒▓▓▓▓▓ │
  32.    └──────────────────────────────────────────────────────────────────┘
  33.  
  34.  
  35.       Every  mailer  sends  a  so  called  site-information  to  the
  36.       connected system. This site-information consists of two parts,
  37.       the   name  and  the   location.  The   default  settings  for
  38.       FrontDoor <tm> are: "noname" and "somewhere". :-)
  39.  
  40.       SITEINFO    startet    as   a    random-siteinfo-changer   for
  41.       FrontDoor<tm>  in November 1991 after having  some beer at one
  42.       of the  legendary DP-CONs ;-). The idea behind siteinfo was to
  43.       change  this  information  after every  connect,  so  the next
  44.       caller  will get a different information.  And exactly that is
  45.       what SITEINFO is doing!
  46.  
  47.       But  SITEINFO is  not only  a silly  changer. You  can exactly
  48.       define a  time and date range for every entry in your database
  49.       (SITEINFO  has it's on  database). Only within  this date- (or
  50.       time-) window this entry can be selected. Further you are able
  51.       do define that a specific entry should only be selectable e.g.
  52.       during the first 10 days of a month (or of specific months) --
  53.       and so on -- have a look at the program itself and try it out.
  54.  
  55.       Last but  not least you can set a 'main-time' for SITEINFO. If
  56.       you  define this  time, only  during this  hours SITEINFO will
  57.       change your informations.
  58.  
  59.       Every   SITEINFO-database  can  contain  200  different  site-
  60.       informations.  One of  them will  be choosen  randomly (if you
  61.       invoke  the proper SITEINFO-function  with -c).  I think, this
  62.       should be enough ... .
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                     RSI - random-siteinfo-system - page 2
  74.  
  75.  
  76.    ┌──────────────────────────────────────────────────────────────────┐
  77.    │  ▓▓▓▓▓▒▒▒▒▒░░░░░       2.) Who may use it ...    ░░░░░▒▒▒▒▒▓▓▓▓▓ │
  78.    └──────────────────────────────────────────────────────────────────┘
  79.  
  80.  
  81.       The answer is short: everybody may use it.
  82.  
  83.       When I  started the development of SITEINFO, I decided to make
  84.       it SHAREWARE! But a little different kind of shareware, the so
  85.       called  CARDWARE! That means that you  have to send a postcard
  86.       to me after an evaluation period of one month to legalise your
  87.       copy of SITEINFO. (The address is shown above.)
  88.  
  89.       Until  today many,  many people are  using SITEINFO  in one of
  90.       it's  versions from 0.1 to 2.10. But  only 17 people sent me a
  91.       postcard  :-((( This is  VERY disappointing, but nevertheless:
  92.       many thanks  to this seventeen (!!) people, you showed me that
  93.       you fully understood the shareware-idea!
  94.  
  95.       Ok,  I will *NOT* make SITEINFO  crippled and I will *NOT* ask
  96.       you  for any money.  The only thing  I'm asking you  for is to
  97.       send me a postcard with your name and your (network-) address.
  98.       Is this really too much?
  99.  
  100.       Starting  with version 2.10  SITEINFO needs a registration-key
  101.       to  be  fully registered!  Note: in  the  unregistered version
  102.       there are *NO* features disabled. The only differences between
  103.       the registered and the unregistered shareware-version are: the
  104.       "[unregistered]"  message on the mainscreen,  a short delay at
  105.       the end (can be broken by a keystroke).
  106.  
  107.       For registration-procedures see REGISTER.TXT
  108.  
  109.  
  110.    ┌──────────────────────────────────────────────────────────────────┐
  111.    │  ▓▓▓▓▓▒▒▒▒▒░░░░░         3.) Using it.......     ░░░░░▒▒▒▒▒▓▓▓▓▓ │
  112.    └──────────────────────────────────────────────────────────────────┘
  113.  
  114.  
  115.       SITEINFO  in it's version  >=2.10 is  supporting the following
  116.       mailer:
  117.  
  118.         Mailer        │ tested with version │  recommended
  119.                       │                     │  environment-variable
  120.       ──────────────────────────────────────────────────────────────
  121.       - FrontDoor       2.02, 2.10             FD
  122.  
  123.       - Intermail       2.10                   IM
  124.  
  125.       - D'Bridge        1.36                   DBRIDGE
  126.  
  127.       - BinkleyTerm     2.56/2.50EE            BINKLEY
  128.  
  129.       - Portal of Power 0.50Γ/0.56ß            POPCMDLINE
  130.  
  131.  
  132.  
  133.       If  you have  not set  the corresponding environment-variable,
  134.       you may call SITEINFO with one of the following parameters:
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.                     RSI - random-siteinfo-system - page 3
  144.  
  145.  
  146.       SITEINFO -FD      FrontDoor
  147.       SITEINFO -IM      Intermail
  148.       SITEINFO -DB      DBridge
  149.       SITEINFO -BK      BinkleyTerm
  150.       SITEINFO -POP     Portal of Power
  151.  
  152.       Optionaly  you  can  give  the  path  (and  filename)  to your
  153.       mailer's configfile, like this:
  154.  
  155.       SITEINFO -BK=D:\BINKLEY\MYCONV.CFG
  156.  
  157.       The  mailerconfig  defaults to:  (%XX% means  the environment-
  158.       variable of your mailer)
  159.  
  160.       FrontDoor         %FD%SETUP.FD
  161.  
  162.       Intermail         %IM%FD.SYS
  163.  
  164.       D'Bridge          %DBRIDGE%DBRIDGE.PRM
  165.  
  166.       BinkleyTerm       %BINKLEY%BINKLEY.CFG
  167.  
  168.       Portal of Power   PORTAL%PORTALTASK%.CFG
  169.  
  170.       SITEINFO will  look exactly in this order. If the environment-
  171.       variable is  not found, the current path will be used. You can
  172.       overrule this scheme by using the shown parameters.
  173.  
  174.       One  exeption is valid  for Portal of  Power: Portals CFG-file
  175.       will only  be searched in the current directory. If you have a
  176.       POPCMDLINE-environment-variable, the TASK-number will be taken
  177.       from  there! e.g.: POPCMDLINE=-T01  results in PORTAL01.CFG as
  178.       Portal's  config-file. If you  want SITEINFO to  use a Portal-
  179.       file  in a different directory, you  MUST give the name on the
  180.       command-line, like this: "Siteinfo -POP=c:\pop\PortalMe.CFG"
  181.  
  182.       Furthermore,  Portal of  Power does  NOT support  changing the
  183.       system-location!  Therefore this  feature will  be disabled in
  184.       POP-mode!
  185.  
  186.       The  FrontDoor  and  Intermail  config-files  are  binary  and
  187.       double-CRC-secured. Binkley and D'Bridge are using plain ascii
  188.       files,  POP an unsecured binary-file. If  the format of one of
  189.       this configuration-files  will ever change, please let me know
  190.       ASAP.
  191.  
  192.       Currently SITEINFO will look up the config-files like this:
  193.  
  194.       D'Bridge:         systemname    ->   line 16
  195.                         location      ->   line 38
  196.  
  197.       BinkleyTerm:      systemname    ->   tag SYSTEM
  198.                         location      ->   tag MYLOCATION
  199.  
  200.       You  can  overrule the  line-numbers for  D'Bridge,  using two
  201.       additional commandline-parameters: (only valid in DB-mode!)
  202.  
  203.       -DB -NAME=<x> -LOC=<y>
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.                     RSI - random-siteinfo-system - page 4
  214.  
  215.  
  216.       In this  case SITEINFO assumes to find the system-name in line
  217.       number  <x>  and  the  location in  line-number  <y>.  If your
  218.       DBRIDGE.PRM  differs  from  that  format  SITEINFO  knows, the
  219.       'additional-informations'  on your screen  may be invalid. But
  220.       if you use the -name and -loc parameters, everything will work
  221.       fine!
  222.  
  223.       ▓▓▓▓▓▒▒▒▒▒░░░░░
  224.  
  225.       Other commandline-parameters:
  226.  
  227.       -?:    Show a summary of commandline-options.
  228.  
  229.       -s:    Skip  the  time  check.  Even  if  you've  specified  a
  230.              maintime for SITEINFO, it'll work at every time. (Still
  231.              ignore the maintime :-)
  232.  
  233.       -f:    Force   every  entry  to   be  processed.  Ignore  it's
  234.              individual time.
  235.  
  236.       -i:    Normally  SITEINFO will  add an  manually entered entry
  237.              (this  is an entry you have not defined within SITEINFO
  238.              but  directly in  your mailer's  configuration) in it's
  239.              database. If you don't want this, simply add "-i".
  240.  
  241.       -y:    Normally SITEINFO will exit automatically after a given
  242.              time  (hardcoded). You can make it 'sit and wait' using
  243.              -y.
  244.  
  245.       -m:    force monochrome-mode. If you dislike the colors ;-)
  246.  
  247.       -nod:  do  NOT use direct-screen-writes  in batchmode! (useful
  248.              e.g. for DesqView)
  249.  
  250.       At least you can give an optinal SITEINFO-RSI-FILE-NAME on the
  251.       commandline. By default siteinfo will use SITEINFO.RSI in it's
  252.       homedirectory. (All RSI-database-files are stored there!)
  253.  
  254.       ▓▓▓▓▓▒▒▒▒▒░░░░░
  255.  
  256.       And now: THE MOST IMPORTANT COMMANDLINE-SWITCH:
  257.  
  258.       -c:    This   switch   envokes  the   proper  RANDOM-SITEINFO-
  259.              FUNCTION!  Only if present, SITEINFO  will search for a
  260.              new  entry, insert it in your  mailer's config and exit
  261.              immediatly.  You *MUST* call SITEINFO like this in your
  262.              mailer-batch:
  263.  
  264.       :LOOP
  265.         CD F:\FD
  266.         SITEINFO -c -fd=f:\fd\
  267.         FD.EXE
  268.         [...]
  269.       GOTO LOOP
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.                     RSI - random-siteinfo-system - page 5
  284.  
  285.  
  286.       ▓▓▓▓▓▒▒▒▒▒░░░░░
  287.  
  288.       Keyboard reference and meanings:
  289.  
  290.       This key         does
  291.       ──────────────────────────────────────────────────────────────
  292.  
  293.       F1               open Helpwindow with keyboard-reference
  294.  
  295.       F2               sort all entries by name
  296.  
  297.       F3               store   this   entry  immediatly   into  your
  298.                        mailer's configuration.
  299.  
  300.       F4/RETURN        EDIT  this entry. If the  actual entry is the
  301.                        active  one, you will be asked wether to edit
  302.                        it,  because SITEINFO  would add  the old one
  303.                        the  next time  you start  it (without "-i").
  304.                        Save  your  work by  pressing  CTRL/RETURN or
  305.                        just RETURN in the last field!
  306.  
  307.       F5               set  all entry-counters to zero. If there are
  308.                        e.g.  4 entries  in SI's queue,  the one with
  309.                        the lowest count has the greatest chance! Set
  310.                        the counters to zero to 'giv'em a chance' ;-)
  311.  
  312.       F6               set  the  starting  and  ending  time  of ALL
  313.                        entries to 00:00.
  314.  
  315.       F7               treat  this entry as  privileged! If there is
  316.                        only  one  privileged  entry  for  a specific
  317.                        time, only this one can be selected!
  318.  
  319.       F8/CTLR-RETURN   get  an  overview-screen of  all  entries. To
  320.                        jump  directly to one  entry, just press it's
  321.                        first letter.
  322.  
  323.       F9               set THIS entry-counter to zero!
  324.  
  325.       F10              set  THIS entry to inactive  -> it will never
  326.                        be selected until you press F10 on this entry
  327.                        again.   Inactive  entries  are  shown  in  a
  328.                        different color in the overview screen.
  329.  
  330.       S                set a starting time for ALL entries.
  331.  
  332.       E                set an ending time for ALL entries.
  333.  
  334.       P                Maintime for SITEINFO. Only within this time-
  335.                        window site-informations will be changed.
  336.  
  337.       D                invoke  a  DOS-SHELL. SITEINFO  will  swap to
  338.                        XMS,  EMS  or  DISK.  Type  EXIT  to  return.
  339.                        If  there  is  no  XMS  or  EMS  available, a
  340.                        temporary   file   will  be   created  (name:
  341.                        SITEINFO.$$$  in the  path pointed  to by the
  342.                        environment-variable TMP or TEMP).
  343.  
  344.       F                search for an entry. Try it...
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.                     RSI - random-siteinfo-system - page 6
  354.  
  355.  
  356.       G                search again (previously selected with F)
  357.  
  358.       INS              Insert a new entry.
  359.  
  360.       DEL              Delete this entry.
  361.  
  362.       Cursorkeys       what can they do? :-))
  363.  
  364.       ▓▓▓▓▓▒▒▒▒▒░░░░░
  365.  
  366.       Logging:
  367.  
  368.       The  logging is a  little bit different in  dependance of your
  369.       mailer:  if you  are using  FrontDoor, Intermail  or Portal of
  370.       Power,  their log-file will be used.  For Binkley and D'Bridge
  371.       SITEINFO  will create an own logfile  in it's directory called
  372.       RSI.LOG.  If you don't want loggind,  just set an environment-
  373.       variable  called NOLOG  and fill it  with any  value, e.g. SET
  374.       NOLOG=bla
  375.  
  376.       ▓▓▓▓▓▒▒▒▒▒░░░░░
  377.  
  378.       Password:
  379.  
  380.       Only  if you  are using  FrontDoor or  Intermail, you  have to
  381.       enter the same password as for your mailer's setup!!!
  382.  
  383.       ▓▓▓▓▓▒▒▒▒▒░░░░░
  384.  
  385.       Opening files:
  386.  
  387.       SITEINFO  will open  the config-files  in "readonly/denynone"-
  388.       mode  for  reading and  "writemode/denywrite" for  writing. If
  389.       there  are any  troubles  or sharing  problems, please  let me
  390.       know.
  391.  
  392.       ▓▓▓▓▓▒▒▒▒▒░░░░░
  393.  
  394.       Length of your SITE-informations!
  395.  
  396.       Please  take in  mind, that the  maximal length  of the *used*
  397.       (NOT  allowed!) site-information depends  on the  type of your
  398.       mailer.  SITEINFO will  show a ruler  on it's  screen which is
  399.       valid  for  FrontDoor.  The system-line  will  be  stripped on
  400.       FrontDoor's  screen  at  character  29,  the  location-line at
  401.       character 30. (Both may be longer!)
  402.  
  403.       Another  short ruler (1---5----0----5----0---!5) is shown just
  404.       for  your orientation.  (Character 24  is extra-marked because
  405.       someone told me, that one mailer - I think it was Binkley - is
  406.       going to strip the information at this position.)
  407.  
  408.       Though  Portal of  Power  supports a  60 character  long name-
  409.       information, Siteinfo will use only the first 50 characters. I
  410.       think this  should fit all needs. Anyway, all other mailer are
  411.       stripping this information!
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.                     RSI - random-siteinfo-system - page 7
  424.  
  425.  
  426.    ┌──────────────────────────────────────────────────────────────────┐
  427.    │  ▓▓▓▓▓▒▒▒▒▒░░░░░      4.) Some last words...     ░░░░░▒▒▒▒▒▓▓▓▓▓ │
  428.    └──────────────────────────────────────────────────────────────────┘
  429.  
  430.  
  431.       I know of sure that I have forgotten something. But I hope you
  432.       can work to your satisfaction with this program!
  433.  
  434.       My greatest thanks goes to my early betatesters:
  435.  
  436.       Eckhart von dem Berge, Fidonet 2:240/500 and 2:240/501 who had
  437.       spend  much time  and expanded  his telefone-bill  for testing
  438.       SITEINFO. Thank you, Ecki!
  439.  
  440.       Hans  Siemons, Fidonet 2:512/149,  who gave  the suggestion to
  441.       make  SINTEINFO Intermail-compatible. (And  who made the world
  442.       famoust chatter - P-CHAT! Have a look on it!)
  443.  
  444.       Many  thanks to Peter Rohde, Fidonet  2:240/1 and 2:240/2 (our
  445.       HOST:-)).  He  gave me  the  structures of  the  D'Bridge- and
  446.       BinkleyTerm-configuration-files  and testet the new behaviour.
  447.       Great, Peter!
  448.  
  449.       Andreas  Klein, 2:246/47 gave me  the needed information about
  450.       Portal of Power. Thank you, Andreas!
  451.  
  452.       BTW: if you send a postcard to me, you will honour their work,
  453.       too! Please take this in mind.
  454.  
  455.  
  456.  
  457.       And now: go on and every time a good 'site-infoing' :-)
  458.  
  459.  
  460.  
  461.       Regards,
  462.       Peter                                 Vechta, 28. Februar 1993
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.